.. _cmsStGetCount:

cmsStGetCount 
================================
--------------------------------


SYNOPSYS
`````````````
.. code-block:: none

    VT_I4 cmsStGetCount ([in] VT_I4 BoardId, [in] VT_I4 Axis, 
    [in] VT_I4 Source, [out] VT_PI4 pdwCount)             

DESCRIPTION
`````````````  

- 지정한 채널의 지정한 카운터의 값을 새로이 설정합니다. 단, 이때 지정하는 카운터값의 
  단위는 펄스수입니다.

\ 

- 이 함수는 카운터의 값을 지정하는 매개 변수(媒介變數)의 단위가 펄스수라는 것을 
  제외하고는 cmsStSetPosition() 함수와 동일합니다.    

\

- 이 함수의 사용과 호출에 있어, 제공된 ㈜커미조아의 함수 헤더 Visual Basic 에서는 함수의
  첨두어 cms 가 붙지 않습니다.


PARAMETER
`````````````

▶ BoardId: 사용자가 설정한 디바이스(보드) ID. 
 
▶ Axis : 축(채널) 번호. 축번호는 상수값으로  0번째 채널을 기준 채널로 임의의 채널을 
설정할 수 있습니다. 
 
▶ Source : 값을 읽을 카운터 번호. 이 값은 다음의 4가지 값중의 하나이어야 합니다. 

  .. csv-table::
   :widths: 10 90
   :header-rows: 1
   :stub-columns: 0

    Value, Meaning
    0 또는 cmsCNT_COMM, Command Counter  
    1 또는 cmsCNT_FEED, Feedback Counter 
    2 또는 cmsCNT_DEV, Deviation Counter : Command와 Feedback counter의 편차 카운터 
    3 또는 cmsCNT_GEN, General Counter : 사용자의 정의에 따라 여러가지 용도로 사용될 수 있는 카운터

▶ pdwCount: 지정한 값으로 대상 카운터의 값을 반환합니다. 이 값은 이 값은 논리단위가 
아닌 실제 펄스 카운트값입니다. 

RETURN VALUE
`````````````

+------------+-----------+
|    Value   | Meaning   |
+============+===========+
|    음수    | 수행 실패 |
+------------+-----------+
| ERR_NONE   | 수행 성공 |
+------------+-----------+

SEEALSO
```````````````

.. seealso:: :ref:`cmsStSetCount`